A:

The first step in using Miles is to initialize the library. You can initialize Miles with the full API or the Quick API.

To open Miles with the full Miles API, follow these steps:

1) On Win32, Win64, MacOS and Linux: call AIL_set_redist_directory to specify the game's local directory that contains the files from the SDK's platform-specific "\redist" directory. (This directory is relative to the location of the Miles library file, so if you are using a relative path, make sure it is relative to the right directory!)

2) On platforms that don't support x86 (Win32) DLLs, including Xbox, Wii, PS2, PS3, Xbox 360, and DOS: call Register_RIB to load modules such as the MP3, Ogg Vorbis, or Voxware decoders if you need them. Usually, you'll just need to add "Register_RIB(MP3Dec)" and/or "Register_RIB(OggDec)". Similarly, "Register_RIB(DSP)" is needed on these platforms to enable DSP filtering. The SRS Circle Surround and Dolby Surround options (where applicable) require "Register_RIB(SRS)" and "Register_RIB(DolbySurround)" calls, respectively. DTS support on the Sony PS2 requires Register_RIB(DTS).

3) Call AIL_startup to initialize Miles.

4) Call the appropriate open function for the subsystems that you plan to use: AIL_open_digital_driver for 2D digital audio, AIL_open_XMIDI_driver for MIDI, etc. Under Win32 and Win64, make sure that you have created an HWND at this point (DirectSound requires this).

If you use the full Miles API to initialize Miles, be sure to call AIL_shutdown to shut everything down when your game is closed.

To open Miles with the Quick API, follow these steps:

1) On Win32, Win64, MacOS and Linux: call AIL_set_redist_directory to specify the game's local directory that contains the files from the SDK's platform-specific "\redist" directory. (This directory is relative to the location of the Miles library file, so if you are using a relative path, make sure it is relative to the right directory!)

2) On platforms that don't support x86 (Win32) DLLs, including Xbox, Wii, PS2, PS3, Xbox 360, and DOS: call Register_RIB to load modules such as the MP3, Ogg Vorbis, or Voxware decoders if you need them. Usually, you'll just need to add "Register_RIB(MP3Dec)" and/or "Register_RIB(OggDec)". Similarly, "Register_RIB(DSP)" is needed on these platforms to enable DSP filtering. The SRS Circle Surround and Dolby Surround options (where applicable) require "Register_RIB(SRS)" and "Register_RIB(DolbySurround)" calls, respectively. DTS support on the Sony PS2 requires Register_RIB(DTS).

3) Call AIL_quick_startup with the appropriate settings for your application. For Win32 and Win64, make sure that you have created an HWND at this point (DirectSound requires it).

If you use the Quick API to initialize Miles, be sure to call AIL_quick_shutdown to shut everything down when your game is closed.